2.3.1 (2025-12-11)

⚠ BREAKING CHANGES

• new lazy-loaded ABR engine (#867)
• remove light version
• player core is the default ES export
• the default ES import is now only the player core plugins need to be explicitly imported

Features

• adaptive-streaming startegies (847f649)
• add internal analytics about new method & profiles (63e06a9)
• add internal analytics about new method & profiles (#699) (a1c8c1e)
• add release-as input to force version (28cb20c)
• add url template for video player profiles (63e06a9)
• add url template for video player profiles (#696) (d60cb4f)
• allow fetching transcript from url (#737) (62b2f52)
• allow transcript from url (#737) (6cd4bc8)
• auto-fetch transcripts from language (#741) (62b2f52)
• auto-fetch transcripts from language (#741) (ac1fc1d)
• bump video player profile package (#860) (fc63d32)
• chapters/transcription template urls (applets) (#888) (cf63bf5)
• custom data video analytics param (2aba293)
• custom data video analytics param (#687) (3f5f828)
• enable player-source config inheritance (847f649)
• fetch auto title & description (#882) (6769344)
• hdr support for HLS streams (847f649)
• karaoke style subtitles (f6e5871)
• kareoke style subtitles (#563) (a6da706)
• kareoke style subtitles (#563) (99c1830)
• light esm build (#765) (e0e803e)
• light esm build (#765) (0049fb9)
• live streams analytics (#862) (bcb3eca)
• migrate to GA4 (#857) (58cf3a7)
• new 'player' method with support async loading & profiles (2aba293)
• new 'player' method with support async loading & profiles (#678) (95098c0)
• new lazy-loaded ABR engine (#867) (847f649)
• schema json exported in build files (#891) (d7526b8)
• source switcher (#904) (c77e1f8)
• subtitles on demand (#898) (e674123)
• support srt subtitle format (#743) (e0e803e)
• support srt subtitle format (#743) (4b69cc0)
• support srt subtitle format (#743) (62b2f52)
• support srt subtitle format (#743) (46b77b1)
• support srt subtitle format (#743) (a0a2598)
• support srt subtitle format (#743) (3461a76)
• video profiles (#539) (0e99c27)
• VIDEO-19871: control-bar download button (#893) (d088057)
• VIDEO-20042: image to video (resourceType: 'image') (#916) (68abf29)
• VIDEO-20073: video-specific config (#920) (210a235)
• VIDEO-20110: video-elements - add support for poster (#926) (2dfb862)
• visual search plugin (#841) (55d5001)

Bug Fixes

• actions (20067c3)
• add big pause button for mobile browsers (ba1f966)
• add lazy-loaded modules to default bundle (#527) (b6019ae)
• add live stream error screen & auto refresh (#819) (9fc9f7a)
• add live streaming profile (#803) (110e11a)
• add OIDC permissions to publish jobs (b7edacf)
• add visual-search to /all bundle (96ac989)
• allow Dash ABR on Safari (#532) (cbf80f4)
• allowUsageReport (#569) (a6da706)
• allowUsageReport (#569) (5d332d2)
• av1 support (#557) (a6da706)
• av1 support (#557) (f6e5871)
• av1 support (#557) (a033c91)
• babel config (0d7b818)
• bump video analytics, trigger analytics event only once (#637) (1b04cc8)
• bump video analytics, trigger analytics event only once (#637) (d5f7a77)
• bump video analytics, trigger analytics event only once (#637) (cbb0d07)
• chapters in Safari (54b2cd2)
• chapters in Safari (#531) (3d77f27)
• chapters innerHTML to innerText (#671) (d9b6251)
• chapters innerHTML to innerText (#671) (124663f)
• cld errors return videojs errors (#872) (c3f6413)
• Contrast (Minimum) (WCAG SC 1.4.3) (#817) (97e36f5)
• controlbar shadow when controls: false (#830) (8f88dd6)
• custom profile docs example (#673) (d9b6251)
• custom profile docs example (#673) (3c728c1)
• debug mode analytics (#611) (4749352)
• default config merge with user config (#827) (19da7aa)
• default secure option for new method (#698) (0d95b76)
• deps-dev: update follow-redirects from 1.15.3 to 1.15.5 (#516) (8c35cec)
• disable component-in-tag for release-please (1389d45)
• docs for profiles & analytics, analytics options (#689) (e771770)
• echo (2212fdf)
• edge to master (#730) (5807863)
• error with f_auto AV1 (#799) (b172e18)
• errors display when using HLS (#880) (ab7db75)
• eslintrc (#604) (a749b23)
• ESM chunk styles (#629) (323492f)
• esm example pages (ME-16168) (#613) (cca439b)
• esm example pages (ME-16168) (#613) (e7c601d)
• esm examples (18a1b4f)
• esm examples (#609) (81c0831)
• fetchLatestRelease (42207bb)
• fetchLatestRelease (831959a)
• fetchLatestRelease (861f614)
• fetchLatestRelease (4e6e721)
• filename generated for download button (#900) (a8d0347)
• Focus Visible (WCAG 2.4.7) (#814) (229fdfb)
• font-face configuration (#886) (9d8e1ac)
• GA deploy workflows (#507) (5f2dd5a)
• github actions deploy workflows (40ebffe)
• github actions deploy workflows (5185b57)
• handle live streams (#641) (1b04cc8)
• handle live streams (#641) (1b04cc8)
• handle live streams (#641) (d5f7a77)
• handle live streams (#641) (db48830)
• handle styled textTracks usage monitoring (bcf3cd0)
• improve example pages, remove duplicates (#831) (4d4fc3b)
• improve focus accent (aa0b798)
• improve release flow (13d31be)
• improve release flow (da7f05b)
• improve release flow (226ce13)
• improve release flow (96f7baa)
• improve release flow (a4a43ff)
• improved analytics (620b4a0)
• Improved example pages with Netlify previews (24763da)
• internal analytics (#878) (0cbf5e7)
• internal analytics (#917) (83e36cc)
• isPlainObject (#598) (7d09a39)
• lazy-loaded playlists (9f89ab3)
• live stream captions display (#826) (0b72dbb)
• make sure we have source on cldsourcechanged (#871) (dd71bfe)
• make video-config configurable (ed1fbef)
• Me 18059 esm tests over preview build (63e06a9)
• merge profile config with source config (#887) (05a6fe4)
• mimetypes (f6e5871)
• mimetypes (#572) (a6da706)
• mimetypes (#572) (4fe8dfc)
• multi-audio tracks (#874) (d8b20b4)
• Non-text contrast (WCAG 1.4.11) (#816) (d78b672)
• notify (8b55411)
• notify (67903db)
• one event for internal analytics (#728) (7552998)
• picture in picture toggle (#522) (8c271cc)
• playlist by tag (#550) (519e737)
• playlist chunk styles (#629) (c2b7131)
• poster image for raw URLs (#573) (a6da706)
• poster image for raw URLs (#573) (f6e5871)
• poster image for raw URLs (#573) (a24d584)
• prevent undefined error when seek-thumbnails are unavailable (#635) (1b04cc8)
• prevent undefined error when seek-thumbnails are unavailable (#635) (d5f7a77)
• prevent undefined error when seek-thumbnails are unavailable (#635) (f07df6b)
• private video poster image (#833) (aa0b798)
• private video poster image (#836) (d51ffd8)
• profiles docs link (#683) (945366f)
• profiles error (#541) (0463518)
• programatic text-tracks in Safari (#747) (62b2f52)
• programatic text-tracks in Safari (#747) (f549240)
• publish (e9a369d)
• publish (14c42fd)
• publish (ddfe32c)
• purge-jsdelivr-cache (2f8bb94)
• raw URLs from CORs restricted origin (3b1baed)
• release & unpublish (03932d5)
• remove braces override (#670) (658d18b)
• remove IE polyfill (#665) (d9b6251)
• remove polyfill (#665) (3e89bc1)
• remove text tracks fallback (#905) (755e72b)
• remove text tracks notifications (#910) (ae94a3b)
• retry on hls not using withCredentials (#912) (9cb213c)
• secure_distribution not passed correctly when fetching profiles (#883) (0a61e34)
• security issue braces (#668) (a0c5496)
• seek-thumbs positioning (#766) (5a16f74)
• seek-thumbs vtt is being called without credentials (#794) (b82d143)
• separate edge/master changelogs (#663) (e2cfc09)
• slack notifications (e44663d)
• small improvements to internal-analytics (acbcd6b)
• source analytics (#738) (6c6f126)
• source switcher on mobile, tap (#908) (91e4b2a)
• split chunks styles (#627) (a2bc622)
• styled subtitles browser compatibility (#576) (efbee25)
• styled subtitles browser compatibility (#576) (ee7f1e2)
• text track with no src should fall-back to transcript (#640) (1b04cc8)
• text track with no src should fall-back to transcript (#640) (d5f7a77)
• text track with no src should fall-back to transcript (#640) (35e54d9)
• type definitions (0f1ab8a)
• types definitions (#565) (a6da706)
• types exports (#565) (f6e5871)
• types exports (#565) (b3e0dd5)
• undeprecate Cloudinary.new() (ONCALL-3380) (#619) (174ee48)
• undeprecate Cloudinary.new() (ONCALL-3380) (#619) (99de793)
• unify styles (ME-16488) (#631) (8e9d659)
• unpublish (cb47571)
• Update CHANGELOG.md (2f8495d)
• update CHANGELOG.md (#555) (edcc655)
• update dependencies (#688) (2aba293)
• update dependencies (#688) (2105a81)
• update dependencies (#746) (e0e803e)
• update dependencies (#746) (1ac07ea)
• update quality selector check icon (#853) (935e1ae)
• update release-please config (1f2c7b7)
• use cld player profiles package for default profiles (63e06a9)
• use cld player profiles package for default profiles (#701) (1083b94)
• use tag_name for release detection- (3b7aa8a)
• use videojs events & re-trigger to analytics package with custom events (ac69bbb)
• use videojs events & re-trigger to analytics package with custom… (#639) (d9b6251)
• use videojs events & re-trigger to analytics package with custom… (#639) (5dc594b)
• VIDEO-19824: errors for missing source-maps (#897) (5079ae2)
• VIDEO-19962: base64 encode public id for video metadata (#906) (bbae229)
• VIDEO-19984: withCredentials support for new hls package (#903) (6a7419e)
• VIDEO-20021: subtitles defined in HLS manifest (#909) (b7b8ec9)
• VIDEO-20091: hide shadow when controlBar is hidden (#924) (12b7166)
• VIDEO-20122: Parsing VTT with cue attributes like 'align' & 'line' (#927) (7795bf6)
• videojs 8 deprecation warning for videojs.bind (#744) (62b2f52)
• videojs 8 deprecation warning for videojs.bind (#744) (7787c36)
• visual search plugin accessibility (#845) (0be5d2d)
• webpack chunk loading global (#625) (323492f)
• webpack chunk loading global (#625) (40278a2)
• withCredentials (ME-16117) (#607) (cca439b)
• withCredentials (ME-16117) (#607) (31e4cbe)

Performance Improvements

• cleanup codec logic (#590) (cca439b)
• cleanup codec logic (#590) (e31b44e)
• debug mode & lazy validators (ME-15925) (#606) (cca439b)
• debug mode & lazy validators (ME-15925) (#606) (74ffd93)
• default export to be base videoPlayer (cca439b)
• default export to be base videoPlayer (#588) (259cb24)
• lazy load ads plugin (#535) (981804d)
• lazy load chapters plugin (#536) (225029b)
• lazy load interaction-areas plugin (03ec928)
• lazy load shoppable plugin (0c87bda)
• lazy loaded recommendation component (cde7922)
• update dependencies (#594) (cca439b)
• update dependencies (#594) (38c5beb)
• utils refactor & cleanup (#595) (cca439b)
• utils refactor & cleanup (#595) (99ba911)

Miscellaneous Chores

• release 2.3.1 (d9fee33)